home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / tvd124r2.zip / TCBVD124.DOC < prev    next >
Text File  |  1993-01-15  |  68KB  |  1,515 lines
  1.                             The Verify Door  v1.24
  2.  
  3.                                January 15, 1993
  4.  
  5.                           Callback Verification Door
  6.                              Re-release to update
  7.                          registration mailing address
  8.  
  9.                     Copyright (c) 1992, 1993 by Jim Lockhart
  10.  
  11.  
  12.  
  13. Chapter        Table of Contents
  14.  
  15.  1.0 ......... Program Description
  16.  2.0 ......... System Requirements
  17.      2.1 ..... Modem Compatibility
  18.      2.2 ..... Setting Up Your HST Modem
  19.      2.3 ..... USR HST 14.4 Suggested Settings
  20.  3.0 ......... Error Handling
  21.  4.0 ......... Demo License
  22.  5.0 ......... Registration License
  23.  6.0 ......... Disclaimer
  24.  7.0 ......... Beta Testing
  25.  8.0 ......... System File Names
  26.  9.0 ......... System Files and Formats
  27.      9.1 ..... TCBV.CNF Short Line by Line Description
  28.      9.2 ..... TCBV.CNF Line by Line Description and Usage
  29.      9.3 ..... TCBVNAL
  30.      9.4 ..... TCBVVER
  31.      9.5 ..... TCBVTIME
  32.          9.5.1 TCBVTIME Parameters
  33.      9.6 ..... TCBVAL
  34.          9.6.1 Dialing String Format
  35.      9.7 ..... TCBVAREA
  36.      9.8 ..... The LOG file
  37. 10.0 ......... The Verify Door Operation
  38.     10.1 ..... Status Bar Description
  39.     10.2 ..... Single Node Operation
  40.     10.3 ..... Multi-Node Operation
  41.     10.4 ..... Exit Codes (DOS Errorlevel)
  42.     11.0 ..... Registering The Verify Door
  43.     12.0 ..... Technical Support
  44.     13.0 ..... Registration Form
  45.  
  46.  
  47.  
  48.       1.0                     PROGRAM DESCRIPTION
  49.                               ───────────────────
  50.  
  51.           The Verify Door (TVD) is a door program designed specifically to
  52.       run  with  PCBoard  v14.x  and  14.5a.  This  program  automatically
  53.       handles verification of your new users phone number by  establishing
  54.       callback verification and supports multi-lingual operation.
  55.           The user enters the door and enters his phone number. The user's
  56.       phone  number  is  checked  against  a  trashcan  file then  against
  57.       previously verified phone numbers and  finally is  checked for  what
  58.       time of day it may be dialed.
  59.          The  door  then  drops  carrier  on  the  user.   After  a  sysop
  60.       configurable  amount of time,  TVD will  disable your  modem's error
  61.       correction if the  user has called  in a  non-error-correcting mode,
  62.       then it will dial the number that the user entered.
  63.          If no modem is found  at the  user end the results are stored and
  64.       TVD  recycles to PCBoard.  If  carrier  is  detected  the   user  is
  65.       prompted  to  enter his password.  If the password entered   matches
  66.       the  password from  that users  record in  the user file the  users'
  67.       security  level is  upgraded along with other optional user settings
  68.       as defined by the  Sysop.  The  user  gets  two  tries  at  entering
  69.       his password.  After the second wrong password entry (or no password
  70.       was entered) the user is disconnected and TVD recycles to PCBoard.
  71.          TVD will attempt to dial the maximum number of times  you have it
  72.       configured for, however, only two CONNECTions are  allowed each time
  73.       the door is run. This helps limits  hackers from tying up your phone
  74.       lines and should also help your long distance phone bill.
  75.          The sysop can locally  ABORT TVD by hitting the  SHIFT+F1 keys at
  76.       any any time. Hitting SHIFT+F1 will abort,  then write a SYSOP ABORT
  77.       message to the log and return to PCBoard.
  78.          This version contains a small  amount of sophisticated  self-test
  79.       code  to  ensure  TCBVDxxx.EXE  executable  file  integrity.  If the
  80.       executable file has been altered in  ANY way,  such as from a virus,
  81.       hacking,  system  drive  problems, etc,  TVD  will let  you know  by
  82.       issuing  an  'Error in file'  warning,  will  stop  running,  and at
  83.       that point your batch file should return to PCBoard. If TVD runs and
  84.       does  NOT display a corrupted file message,  then you can be assured
  85.       that you have received a virus-free and unaltered copy of TVD.
  86.  
  87.  
  88.       2.0                     SYSTEM REQUIREMENTS
  89.                               ───────────────────
  90.  
  91.                  *80286/386/486 required (XT version available)
  92.                  *PC or MS DOS v3.00 or higher required
  93.                  *ANSI.SYS, DVANSI or equiv. should be loaded
  94.  
  95.           TVD  is  multitasking compatible  (at least with  DesqView  v2.3
  96.       and DesqView/X)  and  is also  known to  function  correctly  in the
  97.       Novell  and  3Comm environments.  TVD  will  relinquish  time slices
  98.       during timer countdowns and during user/keyboard input  if  desqview
  99.       is detected.
  100.  
  101.           TVD is compatible with  COM1-8,  IRQ 1-7 and up to 115,200 baud.
  102.       TVD will read your PCBOARD.DAT file and automatically  retrieve  the
  103.       correct communications port attributes from it.
  104.  
  105.           TVD is written in 80286/386 specific code and will not run on an
  106.       8088 (XT) machine.  If you have been running TVD on an XT, a verison
  107.       written to run on the  XT  is available from  Page Three BBS  and is
  108.       downloadable as TVD124XT.ZIP.
  109.  
  110.           TVD is specifically written to run as a PCBoard v14.x  door  and
  111.       should  not  be  expected  to  operate  with  other  bulletin  board
  112.       software, though it is know to run with RBBS.  It is compatible with
  113.       single or multi-node  PCBoard operations,  including the new PCBoard
  114.       v14.5a code (see *note below.)
  115.  
  116.  
  117.       >>> TVD must have access to the following PCBoard system files on
  118.           each node running TVD:
  119.  
  120.           PCBOARD.SYS  PCBOARD.DAT  USERS
  121.  
  122.           TVD can be configured to access either your caller log(s) or
  123.           a separate log file(s).
  124.       
  125.  
  126.     * NOTE: This door will NOT operate on your system if you are using the
  127.             ENCRYPT  program  on your  USERS file!  If  you  are concerned
  128.             about the security of your users file to  the point  where you
  129.             have run the encryption program, then this door is not for you.
  130.  
  131.  
  132.       2.1                     MODEM COMPATIBILITY
  133.                               ───────────────────
  134.  
  135.           TVD has been found to function correctly on the  following brands
  136.       of modems: Hayes, USR, Everex, Cardinal, Telebit, Ven-Tel and Hisland
  137.       modems. It should work OK on most  'Hayes compatible'  modems with or
  138.       without MNP error correction.
  139.  
  140.           The Verify Door will wait for a line  of data  to come  in  from
  141.       your modem that contains a  recognizable  result code string similar
  142.       to that of the HAYES standard.  The following valid result codes are
  143.       parsed  by  TVD.  If  any of  the  following  strings  are  returned
  144.       as result codes from your modem they are handled as described.
  145.  
  146.       "NO ANSWER"─────> call retried
  147.       "BUSY" ─────────> call retried
  148.       "NO DIAL TONE" ─> call retried
  149.       "NO DIALTONE" ──> call retried
  150.       "NO CARRIER"────> call retried
  151.       "CONNECT" ──────> call connected at any baud rate
  152.       "RING " ────────> call retried ─ nasty mode turns on if enabled
  153.       "VOICE" ────────> call retried
  154.  
  155.           If no response is received from  your  modem within  the timeout
  156.       period  specified  in the TVD config file, TVD will make an entry to
  157.       the specified log file and will return to PCBoard.
  158.  
  159.       NOTE TO SYSOPS WITH MNP-EQUIPPED MODEMS:
  160.           TVD will now optionally disable your modems MNP feature  if your
  161.       modem is equipped with it and you enter the command that your  modem
  162.       uses to do so in the  config file.  This feature will eliminate  the
  163.       garbage that a user sees when your MNP modem calls out and  connects
  164.       to the users non-mnp modem.
  165.  
  166.       NOTE TO USR HST USERS:
  167.       If you have recently upgraded your HST to v.42 bis, be sure to check
  168.       and reset S38=0 if necessary.  There is a known bug in some releases
  169.       of the new 'supervisor' chip that sets your S38 register to 255 when
  170.       the chip is first installed!  TVD will not function properly if this
  171.       register is set to more than 2 or 3 seconds,  so set it to 0 just to
  172.       be on the safe side. The command to disable the HST's MNP is &M0 and
  173.       should be placed in the correct location in the TVD config file. You
  174.       should also insert the &M4 command in the modem init string found in
  175.       PCBSETUP.
  176.  
  177.           NOTE TO TELEBIT MODEM USERS: Check and reset S38=0 if needed.
  178.       TVD won't like it one little bit (no pun intended) if  this  setting
  179.       is more than 2 or 3 seconds, so I suggest setting it to 0.
  180.  
  181.       2.2   SETTING UP YOUR HST MODEM:
  182.  
  183.           This door has been written to be compatible with all  parameters
  184.       set by PCBMODEM.
  185.  
  186.           One configuration parameter that  you  should  make  sure  of  -
  187.       dialtone  checking  should  be  ON! There are a few modems that when
  188.       connected to certain telephone company lines do not properly  detect
  189.       the  presence  of a dial tone. If you have had a few of your friends
  190.       or users call and the code just doesn't seem to want  to  call  them
  191.       back,  then  set your modems X parameter to X3 instead of X4. The X3
  192.       setting will disable your modem from sending the NO DIALTONE  result
  193.       code  back to the door code and the door should dial out whether you
  194.       modem thinks there's a dial tone or not. This should not present any
  195.       security problem because when the door dials out, it is looking  for
  196.       the other modem to send carrier. I suggest using the X7  setting  if
  197.       you are using an HST modem.
  198.  
  199.           If you have problems with modem compatibility please report them
  200.       to  Jim  Lockhart at Page Three BBS, (407) 327─8421 (Node 1) or call
  201.       node 2 at (407) 327-4524. (PC-Pursuit users use FLORL)
  202.  
  203.           Include  a  ZIPped  copy  of  your  configuration  (TCBV*.*, and
  204.       error.log files),  a  description of the problem  and what modem you
  205.       are running  including  any  error  codes given by the code when the
  206.       error(s) occurred.
  207.  
  208.       2.3    USRobotics Courier 14400 HST Suggested Settings...
  209.              ──────────────────────────────────────────────────
  210.  
  211.                    B1  C1  E0  F1  M0  Q0  V1  X7
  212.                    BAUD=38400  PARITY=N  WORDLEN=8
  213.                    DIAL=HUNT   ON HOOK   TIMER
  214.  
  215.                    &A3  &B1  &C1  &D2  &G0  &H1  &I0  &J0  &K0
  216.                    &L0  &M4  &N0  &P0  &R2  &S0  &X0  &Y1
  217.  
  218.                    S00=000   S01=000   S02=255   S03=013
  219.                    S04=010   S05=008   S06=002   S07=060
  220.                    S08=002   S09=006   S10=010   S11=050
  221.                    S12=050   S13=000   S14=001   S15=008
  222.                    S16=000   S17=000   S18=000   S19=003
  223.                    S20=000   S21=010   S22=017   S23=019
  224.                    S24=150   S25=000   S26=000   S27=000
  225.                    S28=008   S33=000   S38=000
  226.  
  227.  
  228.           
  229.       3.0                ERROR HANDLING & CARRIER LOSS
  230.                          ─────────────────────────────
  231.  
  232.           Great  pains  have  been  taken  to  make  The  Verify  Door  as
  233.       user-foolproof  and  hacker  proof as possible. In the event of some
  234.       kind of error, an entry is made in the  ERROR.LOG  file,   then  the
  235.       door will disconnect anyone who is still connected  and  recycle  to
  236.       PCBoard.  Hopefully  no  errors will occur, but I don't always write
  237.       perfect programs either!  If carrier  is  lost  for any reason other
  238.       than  the  door  dropping  carrier during  a callback, the door will
  239.       detect loss of  carrier  and  recycle  to  PCBoard.  TVD  will  also
  240.       recycle to  PCBoard  if your modem doesn't respond to  TVD  commands
  241.       or gets no answer from  a dialed  phone number  within the amount of
  242.       time specified in the modem response/no answer timeout setting.
  243.  
  244.           Caution! TVD is not SYSOP  proof.  You  must  take  the time and
  245.       care to configure TVD correctly or you will get  unexpected  errors!
  246.       I suggest using the installation/setup  program that comes with this
  247.       version or you can print out the docs  and carefully do it yourself.
  248.       If you get an error or you cannot get the door to  operate  on  your
  249.       system and you cannot figure out what the problem is,  feel  free to
  250.       call Page Three BBS  (numbers  below) and leave a message or comment
  251.       to SYSOP or Jim Lockhart along with  the error code issued.
  252.  
  253.           Updates  to  TVD  are  always posted  in the upload directory on
  254.       Page Three BBS.  You can always call  and immediately get the latest
  255.       release of The Verify Door unhacked and virus-free any time  without
  256.       having to go through Page Three's verify door.
  257.       Just log in and download it....
  258.  
  259.  
  260.       ANOTHER NOTE: Please remember that, in the event you really  mess up
  261.                     the configuration of this door, your USERS  file  will
  262.                     come to no harm! This door is written so  that it MUST
  263.                     be  running  EXACTLY  right  in  terms  of file access
  264.                     before it will access the USERS file.
  265.  
  266.  
  267.       4.0                   STANDARD "DEMO" LICENSE
  268.                             ───────────────────────
  269.  
  270.  
  271.           The Verify Door is a 'Shareware' program.  I encourage  everyone
  272.       to  upload and share the code. Several limitations must  be  implied
  273.       however:
  274.  
  275.       1) Under no circumstance shall  the code be modified or  distributed
  276.       in any other form than in that which it was originally supplied (the
  277.       original is ZIPped,  but it  may be  distributed  in  other  archive
  278.       formats as long as the de-compressed form of the program remains the
  279.       same).
  280.  
  281.       2) The Verify Door may NOT be redistributed in any manner OTHER THAN
  282.       by  electronic file transfer except in cases approved by the author.
  283.       Receiving money for The Verify Door  program  itself  is  absolutely
  284.       forbidden  to anyone but the author,  except for  telecommunications
  285.       or service charges.   No fee of more than $5.00 shall  be  collected
  286.       in such an instance.
  287.  
  288.       3)  The  Verify  Door  may  be run for an adequate amount of time to
  289.       allow a full testing of the software.  If, after  running  the  code
  290.       for  30  days, you do not purchase the registration license (cost is
  291.       $20.00 US) then this license is terminated and you must  remove  all
  292.       working copies of The Verify Door from your system.
  293.  
  294.       4)  UNMODIFIED  copies  of  The  Verify  Door  and  its files may be
  295.       distributed to ANY bulletin board system anywhere.
  296.  
  297.       5) The demo version may not be "hacked" or modified in  ANY  manner,
  298.       including  but  not limited to modifications leading to the enabling
  299.       of the extended features outlined in this document which are labeled
  300.       as being available only to those systems  running  The  Verify  Door
  301.       with  an  authorized  Verify  Door  Registration  Number.  Under  no
  302.       circumstance may anyone use a registration number in use by  another
  303.       individual.  The  Standard  "Demo"  License as outlined above may be
  304.       withdrawn by the author of The  Verify  Door  at  any  time  without
  305.       exception.
  306.  
  307.  
  308.       5.0                     REGISTRATION LICENSE
  309.                               ────────────────────
  310.  
  311.  
  312.           Users  that decide to purchase a Verify Door Registration Number
  313.       receive several benefits as outlined below.
  314.  
  315.       1) Once  purchased,  the  registration  license  is  non-refundable.
  316.       All future  releases  of  The  Verify  Door written by Jim Lockhart,
  317.       its  present  author,  will  be  compatible  with any   registration
  318.       license  and  The  Verify  Door  Registration  Number  sold  to  the
  319.       individual purchasing the license.
  320.  
  321.       2) The registration license authorizes use of all features marked in
  322.       this documentation as "Registered Version Only."
  323.  
  324.       3)  The  registration  license entitles the holder to free access to
  325.       Page Three BBS, the location of support maintained by the author, as
  326.       long as the holder of the license adheres to the  policies  of  said
  327.       BBS.  Note that Jim Lockhart may not be held liable in any manner or
  328.       for any reason for not supplying said access.
  329.  
  330.       4)  The  registration  license is non-transferable.  The name of the
  331.       bulletin board registered may be changed if evidence is  given  that
  332.       such a change will take place.  It is expressly forbidden to use the
  333.       old registration number once a new one is issued.
  334.  
  335.  
  336.       6.0                          DISCLAIMER
  337.                                    ──────────
  338.  
  339.  
  340.          The  author of this software, Jim Lockhart, is not liable for any
  341.       lost funds, equipment, or data due to the use of this program except
  342.       under  circumstances  where  it  can  be   proven  that   code   was
  343.       intentionally written by Jim Lockhart to do so.
  344.  
  345.  
  346.       7.0                         BETA TESTING
  347.                                   ────────────
  348.  
  349.  
  350.          Each  version of The Verify Door is beta tested  on  the  authors
  351.       system  and  several  close  by,  along  with  other bulletin boards
  352.       choosing  to  beta test new code throughout North America.  I try to
  353.       make sure that when you get a  copy  of  the released  version  that
  354.       there is nothing in the  door that could  possibly go wrong.  Please
  355.       realize that,  though every  effort is made,  some  errors  may slip
  356.       through.  If an error occurs and you can't find the problem on  your
  357.       own then please notify me as soon as possible, despite all the legal
  358.       stuff.  I'll  do  the  best  I can to take care  of any problem with
  359.       successfully running The Verify Door that you might have.
  360.  
  361.  
  362.       8.0                     SYSTEM FILE NAMES
  363.                               ─────────────────
  364.  
  365.  
  366.       ERROR.LOG > This  file  will  be  created  in the directory in which
  367.                   TCBVDxxx resides in the event  of  an error. This is the
  368.                   file you want to look at when  reporting errors that you
  369.                   cannot resolve on your own.
  370.  
  371.       The following files must exist in your Verify Door working directory:
  372.  
  373.       TCBVDxxx.EXE > main executable door code
  374.       WELCOME      > initial user instructions (text)
  375.       WELCOMEG     > initial user instructions (ansi)
  376.       WELCOME.SPA  > Spanish language user instructions (text)
  377.       WELCOMEG.SPA > Spanish language user instructions (ansi)
  378.       TCBVTEXT     > file containing most text messages that appear
  379.       TCBVTEXT.SPA > Spanish version of TCBVTEXT
  380.       TCBVAL       > allowed numbers file listing (described in full detail
  381.                      later in this file)
  382.       TCBVAREA     > area code file of area codes local to you
  383.       TCBVVER      > verified numbers/names/dates file (described later)
  384.       TCBVTIME     > time format file (described later)
  385.       TCBVNAL      > specifically disallowed numbers (described later)
  386.       SETUPxx.EXE  > setup program
  387.  
  388.       Note: TVD supports multi-lingual operation in the same manner that
  389.             PCBoard does. If files are found in the TVD directory that
  390.             have the same foreign language filename extension that the
  391.             user is using, TVD will use them. If not found, TVD will
  392.             default to using the english language prompts.
  393.  
  394.  
  395.       9.0                  SYSTEM FILES AND FORMATS
  396.                            ────────────────────────
  397.  
  398.  
  399.                     TCBV.CNF (configuration file overview)
  400.  
  401.           The TCBV.CNF file is the  main  configuration  file  central  to
  402.       operation  of  The  Verify  Door.   It  includes drive/path/filename
  403.       information on your PCBoard and TVD system files,  TVD  registration
  404.       information and various other feature enable/disable settings.
  405.           For a complete description  of  each  entry  see  the  following
  406.       sections 9.1 and 9.2.  All entries in your  TCBV.CNF  file  must  be
  407.       left justified.
  408.           Please run the SETUPxx.EXE program first if  this is the initial
  409.       installation  of  TVD  on  your  system to  ensure that  the correct
  410.       path names get entered into the config file.
  411.  
  412.  
  413.       9.1  The TCBV.CNF file:
  414.  
  415.       Line Description                                  Example
  416.       ──── ───────────                                  ───────
  417.  
  418.        1  Maximum redial attempts if Local              5
  419.  
  420.        2  Maximum redial attempts if Long Distance      2
  421.  
  422.        3  Enable long distance dialing?
  423.           (Enable = y  Disable = n)                     y
  424.  
  425.        4  Location and name of PCBOARD.SYS file         C:\PCB\PCBOARD.SYS
  426.  
  427.        5  Location and name of PCBOARD.DAT file         C:\PCB\PCBOARD.DAT
  428.  
  429.        6  Name of your BBS (Also see line 8)            Page Three BBS
  430.  
  431.        7  Registration number
  432.           (0 = demo copy)                               0
  433.  
  434.        8  Use system name from PCBOARD.DAT ?
  435.           (Y=use system name from PCBOARD.DAT,
  436.            N=use system name from config file entry)    Y
  437.  
  438.        9  Location and name of log file. May be
  439.           the PCBoard CALLER log or a separate
  440.           text type log.                                C:\DOOR\LOG.TXT
  441.  
  442.       10  Security level of 'new user'                  1
  443.  
  444.       11  Security level to increase user to
  445.           after verifying                               62
  446.  
  447.       12  Amount of time to add to user on line time    5
  448.  
  449.       13  Enable local screen status bar?
  450.           (Y = enable, N = disable)                     y
  451.  
  452.       14  Check trashcan and previously verified
  453.           numbers before dialing?
  454.           (Y or N) (Registered version only)            y
  455.  
  456.       15  Running multi-node or in a network? (Y or N)  y
  457.  
  458.       16  Your time zone. Any time zone designation
  459.           up to 8 characters long may be used.
  460.           Examples: Eastern, Central, Mountain,
  461.           Pacific, EDT, EST, CDT, CST, etc.             Eastern
  462.  
  463.       17  Enable Auto-ANSI color graphics ?
  464.           (enable = Y, disable = N)                     y
  465.  
  466.       18  ALWAYS disconnect user at the completion of
  467.           verification  ?
  468.           (enable=y, disable=n)                         n
  469.  
  470.       19  New expired security for user
  471.           (disable = N)
  472.           (enable = 1, 2 or 3-digit entry)              n
  473.  
  474.       20  Sysop maintained comment field
  475.           (enable = Y, disable = N)                     y
  476.  
  477.       21  Configurable upload/download stats line #1    n
  478.           (Active in Registered versions only)
  479.  
  480.       22  Configurable upload/download stats line #2    n
  481.           (Active in Registered version only)
  482.  
  483.       23  Configurable upload/download stats line #3    n
  484.           (Active in Registered version only)
  485.  
  486.       24  Configurable upload/download stats line #4    n
  487.           (Active in Registered versions only)
  488.  
  489.       25  Delay time before dialing out
  490.           (seconds in addition to built in
  491.           9 second built-in delay)                      0
  492.  
  493.       26  'Nasty' dial out enabled ?
  494.           (n=ask for name only)                         y
  495.  
  496.       27  Modem response/no answer timeout in seconds  60
  497.  
  498.       28  Modem command to disable error correction    NONE (see below)
  499.  
  500.       29  Registration date adjust                      n
  501.  
  502.  
  503.  
  504.       9.2      TCBV.CNF (configuration file - line by line description)
  505.                ────────────────────────────────────────────────────────
  506.  
  507.  
  508. 1     Maximum redial attempts if caller is Local
  509.       ──────────────────────────────────────────
  510.       Options: Recommended setting is 5.
  511.                Valid entries: 2 through 9
  512.  
  513.       This entry sets the maximum number of times TVD will attempt
  514.       to dial out when the last attempt got something other than
  515.       CONNECT* from the modem and the user is calling from a local
  516.       telephone number.
  517.  
  518.       *There is non-configurable maximum of two CONNECTions allowed
  519.        each time TVD is run.
  520.  
  521. 2     Maximum redial attempts if caller is Long Distance
  522.       ──────────────────────────────────────────────────
  523.       Options: Recommended setting is 2.
  524.                Valid entries: 2 through 9
  525.  
  526.       This entry sets the maximum number of times TVD will attempt
  527.       to dial out when the last attempt got something other than
  528.       CONNECT* from the modem and the user is calling from a long
  529.       distance telephone number.
  530.  
  531.       *There is a non-configurable maximum of two CONNECTions allowed
  532.        each time TVD is run.
  533.       
  534. 3     Enable long distance dialing?
  535.       ─────────────────────────────
  536.       Options: y - allow L.D. dialing in accordance with TCBVAL and
  537.                    TCBVTIME
  538.                n - NEVER dial long distance (override other settings)
  539.  
  540.       This entry tells The Verify Door whether or not to EVER call long
  541.       distance to verify a user.  If you set this option to N, TVD will
  542.       NEVER call long distance and will over-ride all other long
  543.       distance calling options you may have set in the TCBVAL file.
  544.  
  545.       Setting this option to Y tells TVD to dial long distance in
  546.       accordance with parameters set in the TCBVAL and TCBVTIME files.
  547.  
  548.  
  549. 4     PCBOARD.SYS file name & location
  550.       ────────────────────────────────
  551.       Entry: Complete drive\path\filename of pcboard.sys
  552.  
  553.       This  entry  tells  The  Verify  Door  the location and name of your
  554.       "PCBOARD.SYS" file.
  555.  
  556. 5     PCBOARD.DAT file name & location
  557.       ────────────────────────────────
  558.       Entry: Complete drive\path\filename of pcboard.dat
  559.  
  560.       This entry tells The Verify Door  the  location  and  name  of  your
  561.       "PCBOARD.DAT" file.
  562.  
  563.  
  564. 6     System Name
  565.       ───────────
  566.       Place the name of you bbs on this line.
  567.  
  568.       If the entry on line 8 is N, then TVD will use the system name as
  569.       you have entered it on line 6.
  570.       If line 8 is set to Y,  TVD will use the system name it reads
  571.       from PCBOARD.DAT and will ignore the entry on this line.
  572.  
  573. 7     Registration number
  574.       ───────────────────
  575.       Place  a  0  on  this  line  if you are running the demo copy
  576.       of The Verify Door.
  577.  
  578.       If you have registered your code place the registration number you
  579.       were supplied with on this line to enable the additional features
  580.       found in the registered software.
  581.  
  582. 8     Use the system name as read from PCBOARD.DAT?
  583.       ─────────────────────────────────────────────
  584.       Options: Y or N
  585.  
  586.       When this option is set to Y, TVD will read your BBS name from
  587.       PCBOARD.DAT and will ignore any entry made on line 6 of the config
  588.       file. When set to N, TVD will read the system name you gave on
  589.       line 6 and will ignore the system name contained in PCBOARD.DAT.
  590.  
  591. 9     Log file
  592.       ────────
  593.       This  line  contains  the  location and name  of  your TVD log.  The
  594.       Verify  Door  will  append to the PCBoard caller file if  specified.
  595.       However,  it  is  recommended that you create a separate log file in
  596.       the directory in which your door code resides.
  597.  
  598. 10    Security level of new user
  599.       ──────────────────────────
  600.       This is the security level of a new user.  If a user enters the door
  601.       and his/her  security level does not match this number the user will
  602.       be returned to the PCBoard system.
  603.  
  604. 11    Security level to raise user to after verification
  605.       ──────────────────────────────────────────────────
  606.       This is the security level you wish to give the user after he/she
  607.       has been successfully verified.
  608.  
  609. 12    Number of minutes to add to time limit after verifying
  610.       ──────────────────────────────────────────────────────
  611.       This is the number of minutes you wish to add to a users time  limit
  612.       after   he/she   has   been   verified.   Since  PCBoard  14.5  will
  613.       automatically adjust the users time after The Verify  Door  upgrades
  614.       his/her  security  level,  it  is  not  necessary to put more than 5
  615.       minutes or so in this option. This feature was included so that  the
  616.       sysop  can  compensate the user for average time spent in The Verify
  617.       Door.
  618.  
  619. 13    Enable local screen status bar ?
  620.       ────────────────────────────────
  621.       Options: Y or N
  622.  
  623.       The Verify Door will display a status bar at the bottom of the local
  624.       screen if this flag is set to Y. This status bar is  meant  to  look
  625.       similar to but not identical with the one PCBoard displays. Set this
  626.       flag to N if you do not wish to have the status bar appear.
  627.  
  628.  
  629. 14    Check  trashcan and previously verified numbers before dialing?
  630.       ───────────────────────────────────────────────────────────────
  631.       Options: Y or N
  632.  
  633.       This option  is  active  only  on  the  registered  version  and
  634.       is ignored on the demo copy.
  635.       If a user is about  to be verified  and this  flag is set to 'y'
  636.       (and the copy you are running is registered) his/her phone number
  637.       will be checked against all entries in the TCBVVER and TCBVNAL
  638.       files and will not be dialed if an entry with the same phone
  639.       number in either file was found.
  640.  
  641.       What will the demo version do?
  642.  
  643.       The demo version of TVD will check only the first three entries
  644.       in the trashcan file TCBVNAL regardless of this setting.
  645.       The verified users file TCBVVER WILL be written to upon successful
  646.       user verification but will NOT be checked for entries with the same
  647.       phone number when another new user who is about to be verified uses
  648.       the door. Registering TVD will fully enable the checking features
  649.       outlined above
  650.  
  651. 15    Running multi-node or in a network environment?
  652.       ───────────────────────────────────────────────
  653.       Options: Y or N
  654.  
  655.       With this flag set to yes, you should have SHARE loaded.
  656.  
  657.       >>>Set this flag to N if you are running one node of PCBoard.<<<
  658.       >>>This flag need NOT be set to Y if you are multitasking and
  659.          running only 1 node of PCBoard<<<<
  660.  
  661.       Setting  this  flag  to Y indicates to the door that you are running
  662.       more than one node of PCBoard and that files such as the USERS file,
  663.       TCBVVER, etc., must be shared by both copies  of  PCBoard  and  both
  664.       copies of The Verify Door.
  665.  
  666. 16    Your Time Zone.
  667.       ───────────────
  668.       You  should  enter your time zone here. Any entry up to 8 characters
  669.       is accepted. This setting is used when a user  calls  long  distance
  670.       and  tries to get verified outside of the time range(s) you have set
  671.       for your system to call long distance. The user  will  get  a  three
  672.       line  prompt  telling  him what the next 'time slot' for calling him
  673.       long distance is.  The  user  is  displayed  the  times  along  with
  674.       whatever  you  put  on  this line of the config file. Some examples:
  675.       Eastern, Central, Pacific, Mountain, EST, EDT, CDT, CST,  MDT,  MST,
  676.       PDT, PST, etc.
  677.  
  678. 17    Enable Auto-ANSI Color graphics ?
  679.       ─────────────────────────────────
  680.       Options: Y or N
  681.  
  682.       With this flag set to "Y" The Verify Door will automatically turn on
  683.       ANSI  color if the user has the color mode turned on in PCBoard. Set
  684.       this flag to "N" if you never want color used in the door no  matter
  685.       what  the  users  settings are in PCBoard.
  686.  
  687.       Note: Color graphics will not appear on the local screen if the
  688.       network/multitasking flag is set to Y.
  689.  
  690. 18    Always disconnect user at end of verification?
  691.       ──────────────────────────────────────────────
  692.       Options: Y, N
  693.  
  694.       If you would like to disconnect the user after a successful  verify,
  695.       then  set  this  flag  to  Y. The door will then disconnect the user
  696.       regardless of whether he is calling long distance or local. Set this
  697.       flag to N if you wish only to disconnect long distance  users  after
  698.       verification.  Users  will  be  automatically disconnected under the
  699.       following conditions:
  700.  
  701.       Keyboard timeout.
  702.       Pressing enter too many times.
  703.       Pressing enter when the door asks for password.
  704.       User enters wrong password twice.
  705.  
  706. 19    New expired security to give user
  707.       ─────────────────────────────────
  708.       Options: 1, 2 or 3 digit number, or the letter N.
  709.  
  710.       Enter the expired security level you wish the verified user  to have
  711.       and it will be written to the users record in  the  user  file  when
  712.       the user is successfully  verified.
  713.       You  can also put N as an entry here if you do not want any change
  714.       in the users expired security level.
  715.  
  716. 20    Sysop maintained comment field enabled?
  717.       ───────────────────────────────────────
  718.       Options: Y or N
  719.  
  720.       This option when set to Y  allows  The  Verify  Door  to  write  the
  721.       verified  user  phone number to the sysop-maintained comment line in
  722.       that users record in the user file. (Comment line #2) Also when this
  723.       option is set to Y and the user was unsucessful at getting verified,
  724.       TVD will give some idea of what happened on comment line #2.
  725.  
  726. 21    Configurable upload/download statistics line #1
  727.       ───────────────────────────────────────────────
  728.  
  729.       Once your new user is verified, you may wish to modify his/her
  730.       upload/download statistics especially if you are running PCBoard
  731.       with some sort of ratio tracking.
  732.  
  733.       Use lines 21, 22, 23 and 24 in the config file if you wish to adjust
  734.       the users record for the following statistics:
  735.  
  736.                                   1st 2 letters
  737.       Statistic type:             of the entry:    Valid range
  738.       ──────────────────────────  ─────────────   ──────────────
  739.       Number of files uploaded          fu        0 to 32767
  740.       Number of files downloaded        fd        0 to 32767
  741.       Number of bytes uploaded          bu        0 to 999999999
  742.       Number of bytes downloaded        bd        0 to 999999999
  743.  
  744.       Make only one entry per line.  These  four  lines may  be configured
  745.       in any order you like (ie,  fuxxx  does  not have to be on line 21).
  746.       Entries should be in the format:
  747.  
  748.                                       ccn
  749.  
  750.       where the first two characters will be one of the following:
  751.             fu, fd, bu or bd
  752.       and where n is any number within the valid range  listed  above.
  753.  
  754.       NOTE: If you do not wish to change ANY of the users  upload/download
  755.       statistics,  enter  an 'n' on each of the four lines. If you wish to
  756.       change only one, two, or three  statistics,  make  your  entries  as
  757.       necessary,  then  make  an  'n'  entry on each of the four lines not
  758.       used.
  759.  
  760.       For  example, lets say you want to give the user credit for one file
  761.       uploaded. The entry would read: fu1
  762.  
  763.       Or, lets say you want to give the user  an  upload  byte  credit  of
  764.       123456 bytes, the entry would read: bu123456
  765.  
  766.       More examples:
  767.       entry:    what it does:
  768.       bu1024    enter 1024 bytes upload credit to the user record
  769.       fu100     enter 100 files upload credit
  770.       fd10      enter 10 files download debit
  771.       bd100000  enter 100000 bytes download debit
  772.  
  773.       Lets  say  you wanted only to enter an upload file credit of, say, 1
  774.       file to the users record, but don't want to change anything else.
  775.  
  776.       Lines 21-24 might look something like this:
  777.  
  778.       fu1              n               n                  n
  779.       n                fu1             n                  n
  780.       n        OR      n       OR      fu1     OR EVEN    n
  781.       n                n               n                  fu1
  782.  
  783.       Any one of those four ways of writing lines 21-24 will get  the  job
  784.       done.  (Yes, this program is so user friendly, you can mix and match
  785.       these four lines as you see fit!)
  786.  
  787.       (Registered version only. Lines 21, 22, 23 and 24 are ignored in the
  788.       demo version)
  789.  
  790. 22    Valid entries described above, see line 21
  791.  
  792. 23    Valid entries described above, see line 21
  793.  
  794. 24    Valid entries described above, see line 21
  795.  
  796. 25    Delay time before dialing out in seconds
  797.       ────────────────────────────────────────
  798.       This setting allows the TVD  to compensate for modems that are  slow
  799.       to disconnect from the phone line and also for slow to respond phone
  800.       lines.   The  Verify Door has a built in 9 second delay, so whatever
  801.       you put on this line of the config file is  in  addition  to  the  9
  802.       second  built in delay. Keep in mind that even though your modem may
  803.       show that the phone is back on hook that  it  takes  up  to  several
  804.       seconds  for  your  users  modem to give up the phone line and issue
  805.       your user a NO CARRIER message.
  806.  
  807. 26    'Nasty' dial out?
  808.       ─────────────────
  809.       Options: Y or N
  810.  
  811.       This  setting  allows  you  to  determine  how TVD  dials out  under
  812.       conditions  that  are  normally  found  only  on  very busy bulletin
  813.       boards. When set to N, The Verify Door will dial out normally and in
  814.       pretty much the same manner as  any  other  communications  program.
  815.       When set to Y, however, The Verify Door will dial out in the 'Nasty'
  816.       mode  where if it detects an incoming call while it's trying to dial
  817.       out, it will pick up your modems phone line, wait  3  seconds  while
  818.       doing  nothing,  hang up, wait 1 second and then attempt to dial out
  819.       to the new user. Use this feature only if you notice a lot of 'RING'
  820.       or 'NO DIALTONE' messages in your doors log file and only if you are
  821.       certain The Verify Door is working correctly.
  822.       This feature is also know as a "forced off-hook" option.
  823.  
  824. 27    Modem no-response/no answer timeout
  825.       ───────────────────────────────────
  826.       Valid entries are 30 to 300 (seconds)
  827.       Suggested setting: 60 seconds
  828.  
  829.       This  setting  allows  you to  determine how  TVD will react if your
  830.       modem does not return  a recognizable  response code to TVD commands
  831.       within the amount of time  you set. It also doubles as  a  NO ANSWER
  832.       timeout in case your modem can't be or isn't configured for it.
  833.  
  834.       TVD makes a log entry of NO MODEM RESPONSE or NO ANSWER  and returns
  835.       to PCBoard upon timing out in either case.
  836.  
  837. 28    Command to issue to your modem to disable error correction.
  838.       ───────────────────────────────────────────────────────────
  839.       Valid entries: Just about anything up to 80 characters long.
  840.                    : An entry of NONE will disable this feature.
  841.  
  842.       NOTE: Enter NONE if your modem does not support error correction
  843.             or if you wish to disable this feature.
  844.  
  845.       This entry should include ONLY the command that your modem requires
  846.       to disable error control (MNP) if your modem has this feature.
  847.  
  848.     * You should also insert a command into your modem's init string by *
  849.     * running pcbsetup to re-enable error correction on your modem      *
  850.     * when PCBoard resets.                                              *
  851.  
  852.       TVD will automatically insert the string you enter here into your
  853.       dialing string after the AT command to disable error control on
  854.       your modem when it is calling a user that has called with a
  855.       non-error correcting modem.
  856.  
  857.       Example: The USR HST modem uses the command &M0 to disable error
  858.                control.
  859.  
  860.       Although this entry will be ignored if your modem does not support
  861.       error correction, you should enter NONE on this line anyway.
  862.  
  863. 29    User registration date adjust
  864.       ─────────────────────────────
  865.       Options: N, 0 or a positive number less than 32767
  866.  
  867.       (Registered version only. Line 29 must be present in the config
  868.        file but is ignored in the unregstered version)
  869.  
  870.       This setting allows the sysop to tell TVD what (or what not) to do
  871.       with the user registration expiration date in the user file.
  872.  
  873.       Setting this option to N or n tells TVD to do nothing with the
  874.       user expiration date.
  875.       Setting this option to 0 tells TVD to set the user expiration date
  876.       to all zeros upon successful verification.
  877.       Setting this option to a positive number specifies the number of
  878.       days TVD will add to the date of successful verification. TVD will
  879.       then update the user expiration date with the calculated date.
  880.  
  881.  
  882.  
  883.       9.3                         TCBVNAL FILE
  884.                                   ────────────
  885.  
  886.           The  phone number trashcan file (TCBVNAL) is used primarily as a
  887.       place to store any SPECIFIC telephone numbers that you do  not  want
  888.       The  Verify  Door to dial (such as the numbers of other local BBS's,
  889.       the police/fire/ambulance numbers, information, etc.) This  file  is
  890.       also used to store telephone numbers that you do not want dialed. To
  891.       do  this  simply place the complete phone number in the file, in the
  892.       following format:
  893.  
  894.  
  895.       aaa-ppp-ssss                      Example:  407-675-3244
  896.        │   │   │                                  900-???-????
  897.        │   │   suffix                   Note: Wildcard (as shown) may be
  898.        │   prefix                       used disallow calling of groups
  899.        area code                        of numbers.
  900.  
  901.       The demo version reads and acts upon only the first three entries in
  902.       this file.  The registered version reads and acts upon  ALL  entries
  903.       in this file.
  904.  
  905. >>>>  BE ADVISED! BE SURE you have the following two entries in your
  906.       TCBVNAL  file:
  907.                                   911-???-????
  908.                                   ???-911-????
  909.  
  910.       The above entries will prevent  the  911  squad  from  showing up at
  911.       your front door step in the middle of the night should some wise-guy
  912.       user decide to enter this as a number to verify!
  913.  
  914.       If  you are running the DEMO version, I suggest making sure that the
  915.       above two entries are the first two entries in  TCBVNAL  because the
  916.       DEMO version reads only the first THREE lines in this file!
  917.  
  918.  
  919.  
  920.       9.4                         TCBVVER FILE
  921.                                   ────────────
  922.           Every phone number successfully verified by  The Verify  Door is
  923.       placed in this file.  The Verify Door adds to this file to store the
  924.       name of the user and the time/date the number was verified.
  925.  
  926.       For example:
  927.  
  928.                  "407-555-1212","JIM LOCKHART","06-25-1990"
  929.                  │              │              │
  930.                  phone number   last, first    date of verify
  931.  
  932.  
  933.    NOTE:  The  demo  version  of  The Verify Door  will  append entries to
  934.           the  TCBVVER  file but  will not  check for previously  verified
  935.           phone numbers.
  936.  
  937.           Once  TVD  is  registered,  it will read all existing entries in
  938.           the  TCBVVER  file  and  will  eliminate the problem of one user
  939.           calling your system using several different log-in names because
  940.           the registered version of TVD will  not call an already verified
  941.           number back.  (This was the main purpose for writing TVD  in the
  942.           first place.)
  943.  
  944.  
  945.  
  946.       9.5                        TCBVTIME FILE
  947.                                  ─────────────
  948.  
  949.           The TCBVTIME file is used in conjunction with the TCBVAL file to
  950.       determine what time of day a number  or  group  of  numbers  may  be
  951.       dialed.   This  feature will help cut down phone costs. The TCBVTIME
  952.       file is a text file that consists of three entries,  each  separated
  953.       by a comma.  Shown below is a diagram of an entry in TCBVTIME:
  954.  
  955.       FORMAT #1
  956.  
  957.       A,17:01,07:55                           (see 9.5.1 below for complete
  958.       ┬ ──┬── ──┬──                            descriptions of each entry)
  959.       │   │     │
  960.       │   │     │
  961.       │   │     stop time
  962.       │   start time
  963.       Time period letter that appears in TCBVAL
  964.  
  965.       FORMAT #2
  966.       A,17:01,07:55,00:00,23:59               (see 9.5.1 below for complete
  967.       ┬ ──┬─  ──┬── ──┬── ──┬──                descriptions of each entry)
  968.       │   │     │     │     weekend stop time
  969.       │   │     │     weekend start time
  970.       │   │     stop time
  971.       │   start time
  972.       Time period letter that appears in TCBVAL
  973.  
  974.  
  975.  
  976.  
  977.       9.5.1                   TCBVTIME PARAMETERS
  978.                               ───────────────────
  979.  
  980.  
  981.       'start time' = This is the time  to start allowing entries with this
  982.       format letter to be dialed.  Valid entries  are  00:00 through 23:59
  983.  
  984.       'stop time'  =  This is the time to stop  allowing entries with this
  985.       format letter from being dialed.  Valid entries are 00:00 thru 23:59
  986.  
  987.       'weekend start time' =  This  optional  entry  is  the  time to start
  988.       allowing entries with this format letter to be dialed on the weekend
  989.       (Saturday and Sunday) Valid entries are 00:00 through 23:59
  990.  
  991.       'weekend stop time' =  This  optional  entry  is  the  time  to  stop
  992.       allowing  entries  with  this format letter  from being dialed on the
  993.       weekend (Saturday and Sunday)  Valid entries are 00:00 through 23:59
  994.  
  995.           The Sysop may define up to 26 different time  periods,  one  for
  996.       each  letter of the alphabet.  After setting a time period up in the
  997.       TCBVTIME file, include the letter you  configured  it  for  in  each
  998.       entry  of  TCBVAL  you  wish to use the TCBVTIME entry defined. If a
  999.       user  calls outside of a valid start/stop time, TVD will display the
  1000.       next available valid time period for calling him back.
  1001.  
  1002.       >>> Please note: 24:00 is NOT a valid time entry.
  1003.  
  1004.  
  1005.  
  1006.       9.6                         TCBVAL FILE
  1007.                                   ───────────
  1008.  
  1009.           The TCBVAL file is used to  tell  The  Verify  Door  what  phone
  1010.       numbers it may call and how to go about doing so.  The Sysop defines
  1011.       what  number(s)  it can dial (exchange, prefix, suffix, and what the
  1012.       user has answered to the long distance question), when they  can  be
  1013.       dialed  (used  in  conjunction  with the TCBVTIME file), and what to
  1014.       send to the modem when dialing the number that matches  that  TCBVAL
  1015.       entry.  The  TCBVAL  file consists of one line for each phone number
  1016.       criteria you wish to give it. Each line entry in this file  consists
  1017.       of four fields.  Shown below is the general TCBVAL entry format:
  1018.  
  1019.  
  1020.       407-???-????,N,A,"ATDT%02%003"
  1021.       ┌── ┌── ┌─── ┌ ┌ ┌───────────
  1022.       │   │   │    │ │ │
  1023.       │   │   │    │ │ dialing string format to send (Note 4 and 9.6.1)
  1024.       │   │   │    │ │
  1025.       │   │   │    │ time period to allow calling (Note 3 and 9.5)
  1026.       │   │   │    │
  1027.       │   │   │    long distance flag (compared to users answer) (Note 2)
  1028.       │   │   │
  1029.       │   │   suffix (? marks used as a wildcard character) (Note 1)
  1030.       │   │
  1031.       │   prefix (Note 1)
  1032.       │
  1033.       area code (Note 1)
  1034.  
  1035.  
  1036.       Notes:
  1037.  
  1038.       1) The phone number field.  This field may consist of digits or  the
  1039.          wildcard  character  "?"  and is  used to  allow you  to  specify
  1040.          certain  area  codes and/or  telephone exchanges that you want to
  1041.          have TVD dial.
  1042.  
  1043.       2) TVD looks for a Y or  N  in  this  field.  This  allows  you  to
  1044.          configure the door so that it knows the format you  want  to  use
  1045.          for dialing a local number as opposed to a long distance number.
  1046.  
  1047.       3) The third field is the letter associated with the time period to
  1048.          allow  TVD  to  dial.  The  letters  and  their associated time
  1049.          periods are listed in the TCBVTIME file.
  1050.  
  1051.       4) The dialing string format field tells TVD how to issue a dialing
  1052.          string for a user phone number. If the letters DP or dp (for
  1053.          pulse dialing) are detected in the dialing string, TVD will wait
  1054.          10 seconds after issuing a dialing command to your modem before
  1055.          beginning the scan for result codes.
  1056.  
  1057.  
  1058.           The Verify Door compares the number that the user  entered  with
  1059.       each entry in TCBVAL until it finds an entry that matches.
  1060.       The more specific entries should be placed at or near  the beginning
  1061.       of the file (the ones with the fewest wildcards).   The Verify  Door
  1062.       will compare the prefix, suffix, and area code and the answer to the
  1063.       long  distance  question.  If  the  number  and  answer  to the long
  1064.       distance question matches with an entry in TCBVAL, that line will be
  1065.       used for dialing the users number.  If not,  The Verify Door will go
  1066.       to the next line and keep going until it reaches a matching entry or
  1067.       the end of the file.  If no match is made,  The Verify Door notifies
  1068.       the user that the number is not available for callback.
  1069.  
  1070.  
  1071.       A NOTE ABOUT LONG DISTANCE DIALING
  1072.  
  1073.           If you  have  configured  TVD  to disable  long distance dialing
  1074.       and the user has answered Y to the long  distance  question,  he/she
  1075.       will see a message that long distance dialing has been disabled.
  1076.       TVD  will  then  return  to  PCBoard  without  dialing out.  See the
  1077.       explanation for line 3 of the  config file  for more  information on
  1078.       disabling long distance dialing.
  1079.  
  1080.       9.6.1 Dialing string Format
  1081.             ─────────────────────
  1082.  
  1083.       The dialing string format tells The Verify  Door  how  to  dial  the
  1084.       telephone  number  (e.g.   ATDT%02%003  or ATDT1%01%02%003 etc.) The
  1085.       table below shows each dialing string  format  and  how  it  affects
  1086.       dialing.
  1087.  
  1088.       Key:      [%01]  = area code user entered
  1089.                 [%02]  = prefix user entered
  1090.                 [%003] = suffix user entered
  1091.  
  1092.       ATDT%02%003      ──   Dials last 7 digits only using Tone dialing
  1093.       ATDT1%02%003     ──   Dials '1' and last 7 digits using Tone dialing
  1094.       ATDT1%01%02%003  ──   Dials '1' +area + 7 digits using Tone dialing
  1095.       ATDP%02%003      ──   Same as above using pulse/rotary dialing*
  1096.  
  1097.  
  1098.       *Note: If you don't have touch tone service on your phone line(s) then
  1099.              change the ATDT entries to ATDP to tell the modem to pulse dial
  1100.              as shown in the example.
  1101.  
  1102.       Sample TCBVAL file
  1103.       ──────────────────
  1104.  
  1105.       407-???-????,N,A,"ATDT%02%003"
  1106.       407-???-????,Y,B,"ATDT1%02%003"
  1107.       ???-???-????,Y,C,"ATDT1%01%02%003"
  1108.  
  1109.       The first line in the sample file allows local calls (user  answered
  1110.       N to the long  distance  question) and the number was within the 407
  1111.       area  code)  to  be  dialed.   For  example,  if  the  user  entered
  1112.       407-555-1212  and  N  to  each prompt in The Verify Door, The Verify
  1113.       Door would send the following string to the modem:  ATDT5551212  and
  1114.       would  allow  the user to remain connected afterwards, returning the
  1115.       user to the PCBoard. (You can configure TVD to ALWAYS  hang  up  at
  1116.       end of verify. See entry #18 of TCBV.CNF file)
  1117.  
  1118.       The  second  line  in the above file would allow Long distance calls
  1119.       within the 407 area code (user  answered  Y  to  the  long  distance
  1120.       question  and  entered  407  as  his area code), the number would be
  1121.       dialed as: ATDT15551212 and would be  disconnected  after  the  user
  1122.       entered  his/her  password  ,  provided the call was within the time
  1123.       period specified by B in the TCBVTIME file. (Long distance calls are
  1124.       ALWAYS disconnected)
  1125.  
  1126.       The third entry in the above file allows Long distance calls outside
  1127.       of the 407 area code (user answered Y to the long distance  question
  1128.       and put in an area code other than 407) provided the call was within
  1129.       the  time  period  specified by C in the TCBVTIME file. Say the user
  1130.       put in 201, 555, 1212, N , for the area  code,  prefix,  suffix  and
  1131.       long  distance  questions  respectively.  The Verify Door would send
  1132.       ATDT12015551212 to your modem and would disconnect  after  the  user
  1133.       entered his/her password.
  1134.  
  1135.       If you intend  send setup  commands to  your  modem  within  the TVD
  1136.       dialing  string you might  first verify  that the dialing string you
  1137.       intend to use  works in  your favorite communications program before
  1138.       putting it into a TVD dialing string.
  1139.  
  1140.       9.7                           TCBVAREA
  1141.                                     ────────
  1142.  
  1143.         The  TCBVAREA  file is used to tell The Verify Door what area code
  1144.       or area codes are in the local calling area for your BBS. This  file
  1145.       is used to prevent callers who have previously been verified and are
  1146.       calling  local from entering a false area code and their real prefix
  1147.       and suffix and then getting verified.
  1148.  
  1149.         Here's how it works: (Registered version only)  If a  caller calls
  1150.       from within your local area code(s) listed in TCBVAREA and tells TVD
  1151.       it is a local call, TVD will temporarily replace the area  code that
  1152.       the user entered with the area code(s)  of your  local  dialing area
  1153.       and THEN will check the TCBVVER file for a duplicate number.
  1154.  
  1155.         Although this file must be in place on your system, TVD will check
  1156.       the  TCBVAREA  and  TCBVVER  files  for false area codes and already
  1157.       verified numbers only when registered.
  1158.  
  1159.  
  1160.       9.8                           LOG FILE
  1161.                                     ────────
  1162.  
  1163.         The log file used by The Verify Door can be configured  to  either
  1164.       append  entries  to your PCBoard caller log or to a log text file of
  1165.       your choice. The path and filename for the log file is configured in
  1166.       the config file for The Verify Door, TCBV.CNF is the default  config
  1167.       file name.
  1168.  
  1169.           Log file entries include the following types of entries:
  1170.  
  1171.           BUSY
  1172.           NO CARRIER
  1173.           VOICE
  1174.           RING DETECTED
  1175.           NO DIAL TONE
  1176.           NO DIALTONE
  1177.           NO ANSWER
  1178.           CONNECT
  1179.           No response from modem
  1180.           Wrong Password: [password entered]
  1181.           Bad Number not dialed
  1182.           User name [date time]
  1183.           Carrier Lost ...
  1184.           Not at new user level
  1185.           Bad number not dialed
  1186.           Aborted
  1187.           Illegal dial time for [phone number]
  1188.           Maximum redials reached
  1189.           [phone number] already verified to [user name]
  1190.           Number dialed: [phone number] [(Long Distance)] [(Local)]
  1191.           User pressed only ENTER when prompted for password
  1192.           Improper or no user response to prompt
  1193.           Successful Verify
  1194.           Caller logged of by TVD
  1195.           Local call returned to PCBoard
  1196.  
  1197.  
  1198.       10.0                The Verify Door OPERATION
  1199.                           ─────────────────────────
  1200.  
  1201.           Invocation of The Verify  Door  (usually  done  by  the  PCBoard
  1202.       running  a  batch file) is pretty straightforward.  Below are sample
  1203.       batch files for invoking The Verify Door. A sample batch  has   been
  1204.       included in the archive for your  convenience.  No  other  auxiliary
  1205.       programs, or drivers are required  as  TCBVDxxx.EXE  is  actually  a
  1206.       stand-alone communications program specifically written to interface
  1207.       with PCBoard.
  1208.  
  1209.           The sysop can abort TVD by pressing SHIFT+F1 at just about  any
  1210.       time during TVD execution.
  1211.  
  1212.           Note: TVD will not work with fossil drivers.  Since PCBoard does
  1213.       not require the use of a fossil driver, it is assumed  that none are
  1214.       in use.
  1215.  
  1216.       ********************************************************************
  1217.  
  1218.       10.1                 Status bar description
  1219.                            ──────────────────────
  1220.  
  1221.           If you have it enabled, a two line status bar will be displayed
  1222.       at the bottom of your screen when TVD is running. It wil display the
  1223.       users name, time, date, security level, modem activity/results, and
  1224.       several countdown/delay timers.
  1225.           Here's what the status bar display means:
  1226.  
  1227.  
  1228.  
  1229.                   User                                               Dial
  1230.                   Baud MNP   User Name         Future  Use          Attempt #
  1231.                  ┌────┐┌┐  ┌───────────┐  ┌───────────────────┐  ┌───────────┐
  1232. ┌─────────────────────────────────────────────────────────────────────────────┐
  1233. │The Verify Door  (2400E)  BILL JONES                            Attempt #  1 │
  1234. │02-02-1992  12:54:57  T/O= 1   Sec= 1    Status: Polling modem       Wait: 59│
  1235. └─────────────────────────────────────────────────────────────────────────────┘
  1236.  └────────┘  └──────┘  └─────┘  └─────┘   └────────────────────┘      └──────┘
  1237.     Date       Time    # Times  Security  Modem result codes and       Timers
  1238.                           On     Level       program activity         (seconds)
  1239.  
  1240.  
  1241.  
  1242.       ********************************************************************
  1243.  
  1244.       10.2  SINGLE NODE OPERATION:
  1245.  
  1246.       cd d:\door                   }  You should put all TVD
  1247.                                       associated files in a separate
  1248.                                       directory
  1249.  
  1250.       tcbvd124 d:\door\tcbv.cnf    }  Command line to invoke the door
  1251.                                       using TCBV.CNF as the configuration
  1252.                                       file and runs The Verify Door.
  1253.       cd d:\pcb                    }
  1254.       board                        }  Returns to PcBoard
  1255.  
  1256.  
  1257.  
  1258.             Suggested PCBSetup Door Security File:
  1259.  
  1260.  
  1261.             Filename    Password    Sec Login SYS  SYS  Shell
  1262.             ══════════ ════════════ ═══ ═════ ════ ════ ═════
  1263.            1) VERIFY                  1   Y    N    N     N
  1264.  
  1265.  
  1266.  
  1267.  
  1268.       ********************************************************************
  1269.  
  1270.       10.3                    MULTI-NODE OPERATION
  1271.                               ────────────────────
  1272.  
  1273.           The  Verify Door performs share-compatible reads/writes with all
  1274.       files.  In the event that the files are not network compatible, your
  1275.       configuration for each  node  must  specify  a  different  filename.
  1276.       Usually  the  best method of doing so is to append a '1', '2' (etc.)
  1277.       to the end of the filename. The files NOT compatible  between  nodes
  1278.       are  listed  below.
  1279.  
  1280.           You should make a different config file for each  node, such  as
  1281.       TCBV1.CNF for node 1, TCBV2.CNF for node 2, and make the appropriate
  1282.       changes in the batch file that loads the door from each node.
  1283.       (See examples below)
  1284.  
  1285.       FILES NOT COMPATIBLE BETWEEN NODES:
  1286.  
  1287.       SYS file       (PCBoard.Sys)
  1288.       LOG file       (Callers log or text file for The Verify Door log)
  1289.  
  1290.  
  1291.    FOR MULTI-NODE OPERATION:
  1292.  
  1293.    NODE1 batch:
  1294.  
  1295.  
  1296.  
  1297.       cd d:\door                   }  You should put all TVD
  1298.                                       associated files in a separate
  1299.                                       directory
  1300.  
  1301.       tcbvd124 d:\door\tcbv1.cnf   }  Command line to invoke the door
  1302.                                       using TCBV1.CNF as the configuration
  1303.                                       file and runs The Verify Door.
  1304.       cd d:\pcb                    }
  1305.       board                        }  Returns to PcBoard node 1
  1306.  
  1307.  
  1308.  
  1309.  
  1310.   NODE2 batch:
  1311.  
  1312.  
  1313.       cd d:\door                   }  You should put all TVD
  1314.                                       associated files in a separate
  1315.                                       directory
  1316.  
  1317.       tcbvd124 d:\door\tcbv2.cnf   }  Command line to invoke the door
  1318.                                       using TCBV2.CNF as the configuration
  1319.                                       file and runs The Verify Door.
  1320.       cd d:\pcb2                   }
  1321.       board2                       }  Returns to PcBoard node 2
  1322.  
  1323.  
  1324.       *******************************************************************
  1325.  
  1326.  
  1327.       10.4                        Exit Codes
  1328.                                   ──────────
  1329.  
  1330.           When a REGISTERED version of TVD completes execution,   it will
  1331.       return one of several possible DOS  Errorlevel  codes  (exit codes)
  1332.       for those sysops who  wish  to  do  additional processing depending
  1333.       on what the user does while in TVD.
  1334.           The following  is a  list of  the exit  codes returned  and the
  1335.       meaning of each:
  1336.  
  1337.  
  1338.       DOS Errorlevel    What it means
  1339.       ──────────────    ─────────────
  1340.  
  1341.             0           Successful verify
  1342.  
  1343.             1           Carrier lost
  1344.  
  1345.             2           Aborted
  1346.  
  1347.             3           User pressed only ENTER at password prompt
  1348.  
  1349.             4           No response from user to prompt
  1350.  
  1351.             5           Not at new user level
  1352.  
  1353.             6           Long distance # not dialed
  1354.  
  1355.             7           Bad # not dialed
  1356.  
  1357.             8           Illegal dial time
  1358.  
  1359.             9           Incorrect password
  1360.  
  1361.            10           Number already verified
  1362.  
  1363.            11           Maximum redials reached
  1364.  
  1365.            99           TVD system error. Check ERROR.LOG
  1366.  
  1367.  
  1368.  
  1369.  
  1370.       11.0                REGISTERING The Verify Door
  1371.                           ───────────────────────────
  1372.  
  1373.       DO NOT REGISTER THIS SOFTWARE IF:
  1374.  
  1375.           Do NOT register this software unless you are satisfied  that  it
  1376.       will fulfill your verify-by-callback requirements!
  1377.           Do NOT register this software if you have not verified  that  it
  1378.       runs successfully on the system on which you intend to run it!
  1379.  
  1380.       REGISTER THIS SOFTWARE IF:
  1381.  
  1382.           Register if you want to prevent users from having more than  one
  1383.       account on  your  system.  The  demo  version  does  NOT  check  for
  1384.       previously  verified  phone  numbers and will happily  call back the
  1385.       same phone number an unlimited number of times!
  1386.           Register  if  you  want  to enable the other 'registered version
  1387.       only' features of The Verify Door.
  1388.           Register just to make my day!   Receipt of your registration  is
  1389.       the same as telling me that you think I did a  good  job and that my
  1390.       hard work is appreciated.
  1391.  
  1392.           In  order to register The Verify Door,  complete   REGISTER.FRM,
  1393.       (or  fill out the  form at the end  of this document  if the form is
  1394.       missing), print it out  and send it to the address shown along  with
  1395.       a check or money order for $20.00 US.
  1396.  
  1397.           You will be mailed a registration number.   After  placing  this
  1398.       number in your  configuration file  you will  have a full registered
  1399.       version  of  The  Verify  Door for this and all future  releases  as
  1400.       stated above, including any updates compatible with PCBoard v15.0.
  1401.  
  1402.           Why  register?   You  are  requested to register The Verify Door
  1403.       after running it for a period of not too much longer than 30 days or
  1404.       so. This door  was NOT  written in an effort to copy other  existing
  1405.       verify doors,  but  in  an  effort to write a verify door that would
  1406.       work properly on my own system where others failed for one reason or
  1407.       another and also to make sysoping a little easier. Since that  time,
  1408.       hundreds of hours of have gone into enhancing and de-bugging TVD and
  1409.       it has grown into a door which many  other PCBoard sysops have found
  1410.       to be both beneficial and useful on their own systems.
  1411.  
  1412.           My  only  request,  then,  is that if you find that using TVD on
  1413.       your  PCBoard  system helps make the  part of  your life  as a sysop
  1414.       easier, then your timely registration is requested.
  1415.  
  1416.  
  1417.  
  1418.  
  1419.       12.0                     TECHNICAL SUPPORT
  1420.                                ─────────────────
  1421.  
  1422.                                  Page Three BBS
  1423.  
  1424.                              Node 1: (407) 327-8421
  1425.                              Node 2: (407) 327-4524
  1426.  
  1427.                                PC-Pursuit: FLORL
  1428.  
  1429.                                24 hours / 7 days
  1430.                         Node 1: 24/96/38.4k baud HST
  1431.                         Node 2: 24/96/14.4/38.4k baud v.32/v.42
  1432.                          Jim Lockhart, Sysop and Author
  1433.  
  1434.           Sysops that  request  access  to  Page  Three  will  be  granted
  1435.       extended privileges only  upon mail registration or by request  when
  1436.       TVD registration is received.  Since there are many people that call
  1437.       Page Three BBS only once or twice to download  The Verify Door it is
  1438.       difficult  and  often  useless to try  to keep  track.
  1439.  
  1440.           If  you  are having a problem getting The Verify Door set up for
  1441.       use on your system, feel free to call Page Three and leave a comment
  1442.       to  the  sysop  describing in as much detail as possible the problem
  1443.       you are having.  Be  sure  and  include  the  ERROR CODE(S)  of  the
  1444.       error(s)  in  question.  (You may find  that a file called ERROR.LOG
  1445.       is in the  directory in which TCBVDxxx.EXE resides)
  1446.  
  1447.           Special thanks to all the PCBoard sysops that gave  their  ideas
  1448.       and recommendations  to  me  for  future versions of The Verify Door.
  1449.       I hope that I've done a good job and that it helps make running your
  1450.       bbs a little easier!
  1451.  
  1452.  
  1453.       13.0
  1454.  
  1455.                        The Verify Door REGISTRATION FORM
  1456.                        _________________________________
  1457.  
  1458.       
  1459.  
  1460.             Sysop name: _________________________________________
  1461.  
  1462.                Address: _________________________________________
  1463.  
  1464.       City, State, Zip: _________________________________________
  1465.  
  1466.           Home phone #: _________________
  1467.  
  1468.           TVD Version : ______v1.24______
  1469.  
  1470.       Please  type  (or print carefully)  below  the  name  of  the bbs to
  1471.       register exactly  as you  want it to  appear on screen.  Mixture  of
  1472.       capital  and  small  letters  is OK.  Your  registration  number  is
  1473.       determined using your bbs name and is CASE SENSITIVE.
  1474.  
  1475.       HINT: You might want to stop now and run PCBSETUP to see exactly how
  1476.             your system name is appears there. It may be different than
  1477.             you think!
  1478.  
  1479.       Board to register:  (EXACTLY as you want it to appear on screen,
  1480.                            case sensitive.)
  1481.  
  1482.  
  1483.           ___________________________________     Phone: ____________
  1484.  
  1485.  
  1486.          Make your check or M.O. for $20.00 US payable to Jim Lockhart
  1487.                                   and mail to:
  1488.  
  1489.                                   Jim Lockhart
  1490.                           The Verify Door Registration
  1491.                                  227 Bennett St.
  1492.                             Winter Springs, FL 32708
  1493.  
  1494.       You will receive your registration number within three weeks after I
  1495.       have  received  your  form  and  payment.  If  you  do not receive a
  1496.       registration number after approximately 3 weeks, please contact Page
  1497.       Three BBS.  If you wish,  I will call your system after your payment
  1498.       is received and leave you a comment with your registration number.
  1499.  
  1500.       If you would like to have me call your system with your registration
  1501.       number, please open a user account for for me per the following:
  1502.       
  1503.       User Name: Jim Lockhart
  1504.  
  1505.       Password : ____________  <==Please write my password here
  1506.  
  1507. ----------- Do not write below this line - 'for office use only' -------------
  1508.  
  1509. Encrypted BBS name :
  1510. Registration number:
  1511. Date notified      :
  1512.  
  1513. ------------------------------------------------------------------------------
  1514.  
  1515.